home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d13 / ps44d.arc / PSEARCH.DOC < prev    next >
Text File  |  1991-03-25  |  72KB  |  1,588 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                    P S E A R C H
  9.  
  10.  
  11.  
  12.                              -------------------------
  13.                              Users Guide and Reference
  14.                              -------------------------
  15.  
  16.  
  17.  
  18.  
  19.                                     Version 4.4D
  20.                                      March 1991
  21.  
  22.  
  23.  
  24.  
  25.                                           ┌─────────┐
  26.                                     ┌─────┴───┐     │              (tm)
  27.                                     │         │o    │──────────────────
  28.                                     │   ┌─────┴╨──┐ │  Association of
  29.                                     │   │         │─┘  Shareware
  30.                                     └───│    o    │    Professionals
  31.                                     ────│    ║    │────────────────────
  32.                                         └────╨────┘    * Member *
  33.  
  34.                                Patri-Soft
  35.  
  36.                           (714) 352-2820 (Voice)
  37.                           (714) 352-2825 (BBS)
  38.  
  39.  
  40.               Copyright 1986, 1987, 1988, 1989, 1990, 1991 by Patri-Soft
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.      PSEARCH Users Guide/Reference                Copyright 1991 Patri-Soft
  48.      ----------------------------------------------------------------------
  49.  
  50.                                Table of Contents
  51.  
  52.  
  53.      Introduction. . . . . . . . . . . . . . . . . . . . . . . . .   1
  54.      Features. . . . . . . . . . . . . . . . . . . . . . . . . . .   2
  55.      Using PSEARCH . . . . . . . . . . . . . . . . . . . . . . . .   3
  56.         Using PSEARCH Menu Mode. . . . . . . . . . . . . . . . . .   3
  57.            Function Selection Menu . . . . . . . . . . . . . . . .   3
  58.            Text Search Entry Display . . . . . . . . . . . . . . .   5
  59.            File Name Search Entry Menu . . . . . . . . . . . . . .   6
  60.            Special Editing Functions . . . . . . . . . . . . . . .   7
  61.            Advanced Options Entry Menu . . . . . . . . . . . . . .   8
  62.            PSEARCH output data display . . . . . . . . . . . . . .   9
  63.         PSEARCH Command Line Mode. . . . . . . . . . . . . . . . .  11
  64.            Command Parameters. . . . . . . . . . . . . . . . . . .  11
  65.         Setting Default parameters in the DOS Environment. . . . .  22
  66.      Screen Colors and Monitor Support . . . . . . . . . . . . . .  23
  67.      Pausing the Search. . . . . . . . . . . . . . . . . . . . . .  23
  68.      Bonus Features for Registered Users . . . . . . . . . . . . .  23
  69.      Maintenance History . . . . . . . . . . . . . . . . . . . . .  24
  70.      Registering PSEARCH and other Patri-Soft Utilities. . . . . .  27
  71.      Site Licenses . . . . . . . . . . . . . . . . . . . . . . . .  28
  72.      VISA/MasterCard Telephone Registration Orders . . . . . . . .  28
  73.      PSEARCH Registration form . . . . . . . . . . . . . . . . . .  29
  74.      Reporting Problems  . . . . . . . . . . . . . . . . . . . . .  30
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.                                      i
  96.  
  97.  
  98.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page  1
  99.      --------------------------------------------------------------------
  100.  
  101.      Introduction
  102.      ------------
  103.  
  104.      PSEARCH lets you easily locate lost or forgotten files on hard
  105.      disks or diskettes.  Since hard disk technology has made 70, 80,
  106.      150 megabyte, and larger hard disks commonplace, users keep more
  107.      information than ever stored in their PC systems.  It is not
  108.      uncommon for users to have over 2000 files on their hard disks.
  109.      This proliferation of files makes it very difficult to store files
  110.      with names and directory structures that can be easily remembered
  111.      and retrieved when files are later needed.
  112.  
  113.      When you need to find a file on your disk but do not know its
  114.      filename or even directory, you most always know something unique
  115.      about this file. If not, you would probably not be searching for
  116.      it.  This unique information might me a person's name, a product
  117.      name, a type of process, or even a location.  Whatever it is,
  118.      PSEARCH can take this information and use it to search all files on
  119.      the disk to identify one or more files that contain this unique
  120.      data.
  121.  
  122.      Since PSEARCH can reduce your search from a list of 2000 files to
  123.      just a few files, your job of locating a file becomes effortless.
  124.      Quick examination of a few files easily lets you know if the
  125.      desired file is on your disk.
  126.  
  127.      PSEARCH users have saved thousands of dollars in time searching for
  128.      files, and time that would have been used to recreate lost files.
  129.      PSEARCH becomes a invaluable tool for all hard disk users.
  130.  
  131.      PSEARCH goes farther than searching for data. Once files are found,
  132.      you can automatically invoke other DOS programs and utilities to
  133.      process them.  PSEARCH becomes a powerful driver for other programs.
  134.  
  135.      In addition to being flexible, PSEARCH is fast!  Our review of
  136.      available text search utilities showed PSEARCH to be the best
  137.      performer.  Our advanced search algorithm combined with
  138.      flexible selection and exclusion criteria insure PSEARCH can
  139.      find your files in the fastest possible time.
  140.  
  141.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page  2
  142.      --------------------------------------------------------------------
  143.  
  144.      PSEARCH has functions and features that make it useful in many
  145.      different situations.  After reviewing this documentation and use
  146.      PSEARCH, we are confident you will find a permanent place for it in
  147.      your arsenal of tools.
  148.  
  149.      Here are a list of some of the many possible uses for PSEARCH.
  150.  
  151.      **   List all files on a hard disk that match a wildcard
  152.           specification.
  153.  
  154.      **   Show the names of any files containing specified text
  155.  
  156.      **   Show text lines of any file containing a specified string.
  157.  
  158.      **   Look for word "Mrs" in any file and preserve case in search.
  159.  
  160.      **   Find 123 files containing the word "BUDGET" and print their name.
  161.  
  162.      **   Compile all C programs that refer to the "RECDESC.H" include
  163.           file.
  164.  
  165.      **   Find a word processing document containing the name "Wiffle".
  166.  
  167.      **   Delete any *.DOC files containing "To: Mr. Johnson".
  168.  
  169.      **   Locate all readonly files existing on a disk.
  170.  
  171.      **   List all files updated today.
  172.  
  173.      **   Build a DOS command to archive manually selected files from one
  174.           or more directories.
  175.  
  176.      **   Search multiple drives attached to the system for text or a file
  177.           name
  178.  
  179.      **   Search for a file name even if it has been archived into .ZIP,
  180.           .ARC or .LZH formats.
  181.  
  182.      **   Limit text search to WORDS, PREFIXES, or SUFFIXES. This greatly
  183.           enhances the search by returning only the data you want.
  184.  
  185.      **   Ability to exclude files from the search process to greatly
  186.           improve search performance.
  187.  
  188.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page  3
  189.      --------------------------------------------------------------------
  190.  
  191.      Using PSEARCH
  192.      -------------
  193.  
  194.      PSEARCH may be executed directly from the DOS prompt or using menus
  195.      that guide you through the process of entering search
  196.      specifications.  Both techniques use the same 'PS' command. PSEARCH
  197.      determines the difference in modes by the presence or absence of
  198.      command line parameters.  When no command parameters are used, menu
  199.      operation is selected.
  200.  
  201.  
  202.      Using PSEARCH Menu Mode
  203.      -----------------------
  204.  
  205.      To start PSEARCH using the menu mode, enter the PS command at the
  206.      DOS prompt and press the <Enter> key.  The following menu will
  207.      be displayed...
  208.  
  209.  
  210.      --------------------------------------------------------------------
  211.      PSEARCH - File Searcher                 Copyright 1991 by Patri-Soft
  212.                                                                                 
  213.                     F U N C T I O N   S E L E C T I O N                         
  214.                                                                                 
  215.             Select the PSEARCH activity you want to perform...                  
  216.                                                                                 
  217.                                                                                 
  218.                  Text Search.  Find Files Containing Text                       
  219.                  Name Search.  Find Files using name patterns                   
  220.                  Help                                                           
  221.                  Exit to DOS                                                    
  222.                                                                                 
  223.  
  224.      --------------------------------------------------------------------
  225.                              PSEARCH Main Menu
  226.  
  227.  
  228.      The PSEARCH menu provides entry to PSEARCH processing.  Menu items
  229.      may be selected by using an highlight bar positioned over the first
  230.      menu item when PSEARCH is started.  Use the cursor arrow keys to
  231.      move the the highlight bar to the function desired and press the
  232.      <Enter> key to start the action.  You may quickly select any item
  233.      by pressing the key relating to the first character of the menu
  234.      item.  For example, press <N> to start a file name search.
  235.  
  236.  
  237.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page  4
  238.      --------------------------------------------------------------------
  239.  
  240.      Following is a description of each menu item:
  241.  
  242.      Text Search.  Activates PSEARCH's text search facility.  You will
  243.                    be presented with a entry menu to allow you to enter
  244.                    specifications PSEARCH is to use to search for data.
  245.  
  246.                    Text Search is PSEARCH's ability to search within
  247.                    files to find specific text.  It allows you to
  248.                    automatically scan you systems disks to locate files
  249.                    containing specific data contents.  For example, you
  250.                    can find all files on the system that contain the
  251.                    name 'Jones'.
  252.  
  253.      Name Search.  Activates the Name search facility.  Name search
  254.                    allows you to use PSEARCH to locate files on your
  255.                    system by the contents of their file names.
  256.  
  257.                    The DIR command provied with DOS only allows you to
  258.                    locate files within any one single directory.  When
  259.                    you have many directories and maybe even multiple
  260.                    hard disks, it becomes impracticle to use the DIR
  261.                    command to locate a file when you do not know what
  262.                    directory it exists in.
  263.  
  264.                    PSEARCH name search can automatically search all
  265.                    directories and even all disk devices to find a
  266.                    specific or pattern file name.
  267.  
  268.      Help          PSEARCH's command line help provides very complete
  269.                    help information on all of PSEARCH's facilities. The
  270.                    help is provided primarily for those that want to use
  271.                    PSEARCH's command line mode of operation but is
  272.                    useful for all to use as a quick reference of
  273.                    PSEARCH's abilities.
  274.  
  275.                    PSEARCH help consists of several pages of scrollable
  276.                    data.  When you exit the help, you will be returned
  277.                    to PSEARCH's main menu.
  278.  
  279.      Exit to DOS.  You may exit PSEARCH menu mode by either selecting
  280.                    the Exit menu item or by simply pressing the <ESCAPE>
  281.                    key from menu mode.
  282.  
  283.                    Upon exiting, PSEARCH will display how long it has
  284.                    been active and provide a summary of its results.
  285.  
  286.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page  5
  287.      --------------------------------------------------------------------
  288.  
  289.      The Text Search Entry Display
  290.      -----------------------------
  291.  
  292.      The following display is shown as a result of selecting the Text
  293.      Search option from PSEARCH's main menu.  It allows you to enter
  294.      specifications indicating the data PSEARCH is to locate.
  295.  
  296.      --------------------------------------------------------------------
  297.      PSEARCH - File Searcher                 Copyright 1991 by Patri-Soft
  298.  
  299.                            Text Search Specification
  300.  
  301.       Path to Search: _______________________________________________
  302.  
  303.       Text(1): _____________________________________________
  304.       Text(2): _____________________________________________
  305.       Text(3): _____________________________________________
  306.       Text(4): _____________________________________________
  307.       Text(5): _____________________________________________
  308.  
  309.        __ Match All?   (Y=All Text must be found  N=Find any matches)
  310.        __ Search Directories  (blank=Current S=System(all)  P=Path only)
  311.        __ Exclude files and directories entered in PSEARCHT.EXC?
  312.        __ Case Sensitive Search? (Y=Match exact text   N=Ignore case)
  313.        __ Qualify (blank=none W=Find Word  P=Prefix S=Suffix)
  314.        __ Showing found text? (Y=ALL N=none F=First match R=Related Text)
  315.        __ Show linenumbers for found text? (Y/N)
  316.        __ Stop scrolling when display full (Y/N)
  317.        __ Pause on each found match?
  318.        _____    For multiple drive search drives to search
  319.        _____    If multiple text, text must within n characters
  320.  
  321.      Keys:  <F3> DOS      <F9> Advanced Options        <F10> Start Search
  322.      --------------------------------------------------------------------
  323.                             Text Search Entry Menu
  324.  
  325.  
  326.      See the command parameter portion of this document for a complete
  327.      description of all the parameters you are allowed to specify on
  328.      this display.
  329.  
  330.      Once all data is entered, you may immediately start the search by
  331.      pressing the <F10> key, or may specify advanced search options by
  332.      pressing the <F9> key.  The advanced options entry menu allows
  333.      further specifications to be made.  You may use the <F3> key to
  334.      temporarily exit to a PSEARCH window to execute DOS commands. You
  335.      may enter any DOS command in this window.
  336.  
  337.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page  6
  338.      --------------------------------------------------------------------
  339.  
  340.      The F10 key may be pressed from any location on this display.  If
  341.      you use the <Enter> key to proceed through each item on the
  342.      display, pressing <Enter> on the last item will begin the search.
  343.  
  344.      All specifications on this display except for pathname and search
  345.      text are maintained in a special PSEARCH control file. This file
  346.      (PSEARCH.DAT) is created the first time you run PSEARCH and is
  347.      placed in the same directory as the PSEARCH program file (PS.EXE).
  348.      This control file allows PSEARCH to retain your search
  349.      specifications for the next time you use it.
  350.  
  351.  
  352.      The File Name Search Entry Display
  353.      ----------------------------------
  354.  
  355.      The File Name Search Display allows you to enter specifications
  356.      PSEARCH is to use while searching for files by name on your system.
  357.  
  358.      --------------------------------------------------------------------
  359.      PSEARCH - File Searcher                 Copyright 1991 by Patri-Soft
  360.                                                                                 
  361.                          Find File Specification
  362.                                                                                 
  363.         Path to Search: ____________________________________________
  364.                                                                                 
  365.                                                                                 
  366.                                                                                 
  367.                                                                                 
  368.        __  Search Directories (blank=Current S=System(all) P=Path only)
  369.        __  Exclude files and directories entered in PSEARCHF.EXC?
  370.        __  Search Archived Files (ZIP/ARC/LZH)? (N=none A=Yes B=Both)
  371.        __  Stop scrolling when display full (Y/N)
  372.        __  Pause on each found match?
  373.        __  Flex Search:  =none  S=Sound like  V=NoVowels  C=CharsOnly
  374.  
  375.        _____     For multiple drive search, letter of drives
  376.  
  377.  
  378.  
  379.                                                          
  380.                                                                                 
  381.      Keys:  <F3> DOS       <F9> Advanced Options       <F10> Start Search
  382.      --------------------------------------------------------------------
  383.  
  384.      This entry screen works like the Text Entry display discussed earlier.
  385.      See the command parameter descriptions for more information about the
  386.      parameters you may enter.
  387.  
  388.  
  389.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page  7
  390.      --------------------------------------------------------------------
  391.  
  392.      Special Editing Functions
  393.      -------------------------
  394.  
  395.      Special edit functions are provided to enhance your capability
  396.      to specify DOS pathname and text specifications.  These following
  397.      features are available on all specification entry screens.
  398.  
  399.         Field Edit  --  You are presented with pathname and text
  400.                         specifications from prior executions on the
  401.                         parameter input displays.  You may use the
  402.                         shown value by simply pressing <Enter>.
  403.  
  404.                         You may change the value by first pressing a
  405.                         field edit key such as left or right cursor
  406.                         arrow, <INS>, or <DEL>.  Then you may edit
  407.                         the field as desired.
  408.  
  409.                         Entering any other value causes the current
  410.                         field to disappear and to be replaced by the
  411.                         keyed in value.
  412.  
  413.         Restore Field   Press alt-X when you are editing a field to
  414.                         restore it to its original value.
  415.  
  416.         Lower Case      Press alt-L to convert all characters in the
  417.                         field to lower case.
  418.  
  419.         Upper Case      Press alt-U to convert all characters in the
  420.                         field to upper case.
  421.  
  422.         Captialize      Press alt-C to cause all words in the field to
  423.                         be capitalized and other characters to be changed
  424.                         to lower case.
  425.  
  426.         Reverse         Press alt-R to reverse the characters in the
  427.                         in the field (first=last and last=first).
  428.  
  429.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page  8
  430.      --------------------------------------------------------------------
  431.  
  432.      Advanced Options Entry Display
  433.      ------------------------------
  434.  
  435.      The Advanced Options Entry Display allow specification of advanced
  436.      options to be used for both Text and File name searches.  These
  437.      options are not necessary for PSEARCH to function and may be
  438.      ignored if desired.
  439.  
  440.      --------------------------------------------------------------------
  441.      PSEARCH - File Searcher                 Copyright 1991 by Patri-Soft
  442.                                                                                 
  443.                           Advanced Options Screen                               
  444.                                                                                 
  445.        __ Print and Display all results? (Y/N)
  446.        __ Log and Display all results? (Y/N)    Log file PSLOG.TXT
  447.        ____  Files Attributes U=Updated H=Hidden S=System R=Readonly
  448.  
  449.           For each matching file PSEARCH can generate and optionally
  450.           execute any desired command.  Specify the command below:
  451.  
  452.        __ Action?  blank=none  W=Write to PSCMDS.BAT file  X=Execute
  453.                                P=Execute command with pause after each
  454.  
  455.         Execute Command: _____________________________________________
  456.  
  457.           The following characters may be used in the command to
  458.           generate commands with the matching directory and filename.
  459.                &=path  #=Filename  !=File  @=/  ~=Archive name
  460.                For example, to copy all matching files to drive A:
  461.                    Command: COPY & A:
  462.  
  463.  
  464.       Keys:       <F3> DOS           <F10> Start Search
  465.      --------------------------------------------------------------------
  466.                       Advanced Options Entry Screen
  467.  
  468.      See subsequent sections in this document for more information about
  469.      the advanced specifications that may be entered on this display.
  470.      Once all specifications are entered you begin the search by
  471.      pressing the <F10> key on any field, or by pressing the <Enter> key
  472.      from the last entry field on the display.
  473.  
  474.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page  9
  475.      --------------------------------------------------------------------
  476.  
  477.      The PSEARCH Output Data Display
  478.      -------------------------------
  479.  
  480.      The following display is a sample of PSEARCH output as a result of
  481.      a TEXT Search request.
  482.  
  483.      --------------------------------------------------------------------
  484.      PSEARCH - File Searcher                 Copyright 1991 by Patri-Soft
  485.      Searching *.* for (this)  Opt ==> SHOW MULT ANYCASE MORE
  486.      --------------------------------------------------------------------
  487.      Searching *.* files for string (this)
  488.  
  489.      ======> FINANC.LTX       3287  16FEB89  6:42p
  490.      I am unable to determine what happened to this specific order.
  491.      to me.  I may be having trouble with this new address.  I know
  492.      In any case, I have corrected the problem and hope this package
  493.      normally sent to users.  If this is
  494.  
  495.      ======> ENHANREQ.LTR     2733   1MAR89  6:04a
  496.             drives.  This invokes the no⌐window mode.
  497.  
  498.      ======> HUFFMAR          1658  10MAR89  7:35a
  499.             A copy of the agreement is supplied with this
  500.  
  501.      ======> PRINT.TXT        1104   4MAY89  7:47a
  502.             receive no royalties from this product but I have agreed
  503.  
  504.      ======> LTR.LTR          2821   9JUN89  9:54a
  505.             drives.  This invokes the no-window mode.
  506.  
  507.      ** More?  <Enter> for more, <C> for continuous, <ESC> terminate ***
  508.      --------------------------------------------------------------------
  509.      Path(#1) C:\WP                               27  FILE=  WILLAM.BRO
  510.      --------------------------------------------------------------------
  511.                          PSEARCH Output Display
  512.  
  513.  
  514.      The top and bottom portion of the output display are reserved for
  515.      statistical information to keep you aware of what PSEARCH is
  516.      searching during processing.  The center portion of the display
  517.      shows the data found that matches the search specifications.
  518.  
  519.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 10
  520.      --------------------------------------------------------------------
  521.  
  522.      For each found text match, PSEARCH displays the file name and data
  523.      matching the search criteria.  The filename is shown on a line
  524.      before the matching text.  This line also shows the date and time
  525.      the file was last updated or created and the size of the file in
  526.      characters. If DOS attributes are present in the DOS directory
  527.      entry for the file, they are also shown.
  528.  
  529.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 11
  530.      --------------------------------------------------------------------
  531.  
  532.      PSEARCH Command Line Mode
  533.      -------------------------
  534.  
  535.      The following section describes the use PSEARCH using command
  536.      line specifications.  These specifications all you to enter
  537.      all PSEARCH options directly on the PSEARCH command when it is
  538.      entered to DOS.  Although more difficult to master, the command
  539.      line mode is the easiest and fastest to use once you learn how
  540.      to use PSEARCH.
  541.  
  542.  
  543.      Command Parameters
  544.      ------------------
  545.  
  546.      Command parameters control PSEARCH's may different features when it
  547.      is use in command line mode at the DOS prompt. They are easy to
  548.      understand and learn, and provide you need to quickly locate all
  549.      files. Remember that each parameter is summarized in the online
  550.      help display. Just type PS at the DOS promot.
  551.  
  552.  
  553.      COMMAND FORMAT:
  554.  
  555.      PS [fspec] /T:text /F /S /C /P /PR /PF /MO /O:nn/N:nn /NW /TA
  556.                 /X[F][P]:cmd /AT:c /FW /FP /FS /DR:xxx /SO /AR /AO
  557.  
  558.  
  559.      PS - PS is the name of the PSEARCH command.
  560.      PS actually refers to Patriquin's PSEARCH. Enter the command without
  561.      any parameters for menus and help.
  562.  
  563.      [fspec]
  564.            Enter the DOS file specification for the directory and file
  565.            names to be searched. If no directory name is specified the
  566.            current directory will be searched. If the /S option is
  567.            specified, the directory name portion of this parameter is
  568.            not used.
  569.  
  570.            Like DOS, use the '*' to indicate the last part of a filename
  571.            or filename extension may be any set of characters.  Also
  572.            like DOS, use the '?' to indicate that any single position of
  573.            a filename may be any character.
  574.  
  575.            In addition to DOS, you may place an '*' anywhere in the
  576.            filename to indicate any set of characters may exist in this
  577.            point in the name.
  578.  
  579.  
  580.      SPECIAL FLEX FILENAME SEARCHING CONTROL CHARACTERS
  581.  
  582.            The filename specification may contain a full DOS pathname
  583.            including the standard DOS wildcard characters * and ?. In
  584.            addition the special characters '~', '!', or ';' may be
  585.            placed immediately before the filename to specify special
  586.            filename find criteria.
  587.  
  588.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 12
  589.      --------------------------------------------------------------------
  590.  
  591.                 ~ SOUNDEX -- Select any filename that sounds like the
  592.                              specified name
  593.                      ~WORD would select:
  594.                             WORD WOOORD WRD WOOD WORLD
  595.  
  596.                 ; NOVOWEL -- Select equal filenames but ignore vowels
  597.                              AEIOU in name
  598.  
  599.                      !WOORD would select:
  600.                             WoRD WoooRD WieRD WRD
  601.  
  602.                 ! CHARS -- Select any filenames that contain the
  603.                            characters entered
  604.                      !WD would select:
  605.                             WorD.dat WilDone.dat lstWorD.x
  606.  
  607.            Following are examples:
  608.  
  609.              1.    *.EXE
  610.              2.    TEST*.*
  611.              3.    *TEST*.*
  612.              4.    DO?FIX.*
  613.              5.    PC*XX.*
  614.              6.    C:\DOS\*.*
  615.              7.    \TEST\*.*
  616.              8.    !WD*.*
  617.              9.    ~WORD.*
  618.  
  619.      SPECIFY A LIST OF FILES TO BE SEARCHED
  620.  
  621.             As an alternative, a file containing a list of input files may
  622.             be supplied.  Create  a file containing lines  with a filename
  623.             or complete pathname on  each line.  Provide  this filename as
  624.             the source filename to PSEARCH and add an @ character before the
  625.             name.  The list of files will be processed as if they were all
  626.             specified on the input command line.
  627.  
  628.             For file list processing,  PSEARCH understands the output of the
  629.             DOS DIR command.   You may use the  DOS redirection feature to
  630.             direct DIR output  to a file, edit  the file to add  or remove
  631.             entries,  and  then  provide this  to  PSEARCH  as  input.   For
  632.             example:
  633.  
  634.             DIR \TURBOC\C\*.C > FILE.LST
  635.             PSEARCH @FILE.LST /T:TEXT
  636.  
  637.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 13
  638.      --------------------------------------------------------------------
  639.  
  640.      /AO   Archive type files Only - If you have files on your system
  641.            that are compressed into archive files with DOS extension
  642.            names of .ZIP, .ARC, or .LZH, PSEARCH is to search only these
  643.            files. This parameter is only useful for file name searching.
  644.            PSEARCH does not decompress these file contents for text
  645.            search requests.
  646.  
  647.            When specified, this parameter specifies that all archive
  648.            files are to be internally searched for filenames compressed
  649.            in them that meed the specified file specification.
  650.  
  651.            Note, you do not specify .ARC, .ZIP, or .LZH in the PSEARCH
  652.            file specification.  PSEARCH will automatically find and
  653.            search these files.
  654.  
  655.  
  656.      /AR   ARchive type files as well as normal files -  PSEARCH will
  657.            search both archive files and non-archive files for matching
  658.            filename specifications.  Use only for file name searches.
  659.            (See also the /AO command parameter).
  660.  
  661.  
  662.      /AT:c ATtributes - Specifies that PSEARCH is to search for files
  663.            having one or more of the attributes specified by the /AT:
  664.            parameter.
  665.  
  666.                 U - Updated,the ARCHIVE bit is on to indicate the file
  667.                     has been updated since the last backup.
  668.  
  669.                 R - Readonly,Files marked with Readonly attribute.
  670.  
  671.                 H - Hidden,Files marked with Hidden attribute.
  672.  
  673.                 S - System, Files marked with System attribute.
  674.  
  675.            Use /AT:U to locate all files that have been updated since
  676.            your last backup was done.
  677.  
  678.            Use /AT:H to determine what hidden files exist on your
  679.            disks.
  680.  
  681.  
  682.      /C Case - Indicates that text search requests are to be case
  683.            sensitive.  That is, exact upper/lower case searching
  684.            will be done.
  685.  
  686.            Normally it is easier to let PSEARCH find text data
  687.            regardless of its case.  This allows you to be sure to find
  688.            any possible matches.
  689.  
  690.            Exact case searching is useful for those cases where you know
  691.            the text is specified in an exact way.  It potentially
  692.            reduces the number of false matches that may be encountered
  693.            during the search.
  694.  
  695.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 14
  696.      --------------------------------------------------------------------
  697.  
  698.      /DR:  DRive list. If the drive is not specified in the main
  699.            pathname, PSEARCH will search the current disk device. /DR:
  700.            indicates one or more drives that the search is to be
  701.            performed on. The following example indicates the search is
  702.            to be done on drives C and D.
  703.  
  704.                /DR:cd
  705.  
  706.            The drive list is especially useful for searching all drives
  707.            on a system containing multiple hard disks.  Specify this
  708.            parameter in the PSEARCH= environment variable to force it to
  709.            be in effect for all command line executions.
  710.  
  711.  
  712.      /DS   Directory path search.  Normally PSEARCH will search only the
  713.            current directory or the entire disk of /S is also specified.
  714.            The /DS parameter indicates PSEARCH is to search the
  715.            specified or current directory and all of its subordinate
  716.            directories for files.
  717.  
  718.            This parameter is useful for those system that have well
  719.            structured hard disk directories.  For example, PSEARCH can
  720.            easily search all word processing directories if all these
  721.            directories are subordinate to a single high level directory
  722.            name.
  723.  
  724.            If you have a directory structure like the following...
  725.  
  726.                C:\                    Root directory
  727.                C:\WPSYS\              Word processing system files
  728.                C:\WP\                 Word processing data files
  729.                C:\WP\PLANNING\        Planning documents
  730.                C:\WP\MEMOS\           Memos
  731.                C:\WP\STANDARD\        Polocies and Procedures
  732.  
  733.            Use the following PSEARCH command to search for all documents
  734.            containing the text "emergency"...
  735.  
  736.                PS C:\WP\*.*/t:emergency/ds
  737.  
  738.            Only the word processing document files will be searched.
  739.            All other directories on your hard disk will be ignored.
  740.  
  741.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 15
  742.      --------------------------------------------------------------------
  743.  
  744.      /EX   Exclude files.  Primarily intended for text search requests,
  745.            the exclude facility allows you to provide a list of pathname
  746.            and filename specifications that are to be excluded from
  747.            PSEARCH processing.  Since searching through data on your
  748.            hard disk requires extensive processing and disk read time,
  749.            excluding files from the process will save you time, and will
  750.            reduce the number of false matches displayed for your
  751.            requests.
  752.  
  753.            The most common files to exclude from text search processing
  754.            is product program and control files.  These files constitute
  755.            a large portion of your hard disk's used space and
  756.            unnecessarily lengthen the time it takes searches to locate
  757.            the desired data.
  758.  
  759.            The exclude facility is implemented with two actions.  First,
  760.            you will need to create an exclude specification file and
  761.            place it in the same directory where PSEARCH is installed on
  762.            your hard disk.  This file will contain the names of all the
  763.            files and paths to be excluded.  You may specify DOS pattern
  764.            names to exclude groups of files with a single specification.
  765.  
  766.            Like DOS, use the '*' to indicate the last part of a filename
  767.            or filename extension may be any set of characters.  Also
  768.            like DOS, use the '?' to indicate that any single position of
  769.            a filename may be any character.
  770.  
  771.            In addition to DOS, two additional pattern features are
  772.            available.  You may place an '*' anywhere in the filename to
  773.            indicate any set of characters may exist in this point in the
  774.            name.  For pathnames, you may place an '**' at the end of a
  775.            directory path specification to indicate the specification
  776.            applies to the specified directory and all subordinate
  777.            directories.  Using '**', you can exclude an entire path with
  778.            a single specification.
  779.  
  780.            You must tell PSEARCH what you want selected for search, and
  781.            what you want excluded.  PSEARCH supports both of these, making
  782.            use of the SEL and EXC commands.  Placing a SEL in front of the
  783.            filename or pattern tells PSEARCH to select that file, while
  784.            putting an EXC tells PSEARCH to exclude it.  If nothing is
  785.            specified, PSEARCH assumes EXC.
  786.  
  787.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 16
  788.      --------------------------------------------------------------------
  789.  
  790.  
  791.            Following are examples:
  792.  
  793.              1.    EXC *.EXE
  794.              2.    *.COM
  795.              3.    EXC TEST*.*
  796.              4.    EXC *TEST*.*
  797.              5.    EXC DO?FIX.*
  798.              6.    ESC PC*XX.*
  799.              7.    EXC C:\DOS\*.*
  800.              8.    EXC \TEST\*.*
  801.              9.    EXC D:\GAMES**\*.*
  802.              10    SEL TEST.XXX
  803.              11    SEL FIND.EXE
  804.  
  805.            Explanations for the above examples:
  806.              1.  Excludes all filenames with the extension .EXE from
  807.                  processing.
  808.  
  809.              2.  Excludes all filenames ending with extension .COM.
  810.  
  811.              3.  Excludes all filenames beginning with the letters
  812.                  "TEST" from processing.
  813.  
  814.              4.  Excludes all filenames having the characters "TEST"
  815.                  anywhere in the first portion of the filename.
  816.  
  817.              5.  Exclude files having 'DO' as the first 2 characters of
  818.                  the filename, and 'FIX' as the 4th, 5th, and 6th
  819.                  filename characters.  The 3rd character of the filename
  820.                  may be any character.
  821.  
  822.              6.  Exclude files having a name beginning with the 2
  823.                  characters PC and where the first portion of the
  824.                  filename ends with the characters 'XX'.  Any 0 to 4
  825.                  characters may exist between the 'PC' and 'XX' in the
  826.                  first portion of the filename.
  827.  
  828.              7.  Exclude all files from the DOS directory on drive C:.
  829.  
  830.              8.  Exclude all files from the TEST directory existing
  831.                  on any drive searched.
  832.  
  833.              9.  Exclude all files from the D:\GAMES\ directory and
  834.                  also exclude all files and directories subordinate
  835.                  to the GAMES directory.
  836.  
  837.              10. Even though all files containing the word TEST are
  838.                  excluded, using a SEL statment tells PSEARCH to search
  839.                  just that filename or pattern.
  840.  
  841.              11. Same concept as above.  Even though all the *.EXE files
  842.                  are excluded, the SEL statement forces PSEARCH to look
  843.                  in that file.
  844.  
  845.  
  846.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 17
  847.      --------------------------------------------------------------------
  848.  
  849.            Exclude file names --
  850.  
  851.               Since you may want to exclude different files from
  852.               file find and text search requests, a different
  853.               exclude file name exists for each.
  854.  
  855.                  PSEARCHF.EXC  --  File Find exclude specifications
  856.                  PSEARCHT.EXC  --  Text Search exclude specifications
  857.  
  858.               These files may be created using most any word processor
  859.               or text editor.  If you have no word processor or editor
  860.               you may use the EDLIN text editor provided with your DOS
  861.               system.
  862.  
  863.               The exclude files must exist in the same directory the
  864.               PS.EXE file is located on.  PS.EXE is the name of the
  865.               PSEARCH program file.
  866.  
  867.            Activating exclude --
  868.  
  869.               Exclude will only be functional when the /EX command
  870.               parameter is specified.  When /EX is specified, you must
  871.               have a valid exclude file.  PSEARCH will not continue
  872.               without one.  If you wish exclude to be active during all
  873.               executions, specify /EX as part of the PSEARCH= DOS
  874.               environment variable.  See later in the documentation for
  875.               a description of this feature.
  876.  
  877.  
  878.      /F    Find File in the current directory.  Normally PSEARCH will
  879.            search all directories to find a file.  Use the /F parameter
  880.            to limit PSEARCH to search only the specified or current
  881.            directory.
  882.  
  883.  
  884.      /FP   Find Prefix - (use with /T:) Indicates that matching text
  885.            must be at the end of an existing word.  Designed primarily
  886.            for word searches, find prefix qualifies the search to help
  887.            you find exactly the match you want.
  888.  
  889.  
  890.      /FS   Find Suffix - (use with /T:) Works like find prefix, except
  891.            finds the matching text only if it preceeds an existing word.
  892.  
  893.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 18
  894.      --------------------------------------------------------------------
  895.  
  896.      /FW   Find Word - (use with /T:) The text to be searched for is a
  897.            word. Only select text that is a complete word. A word is
  898.            defined as any string of characters and numbers that is not
  899.            preceded or succeeded with other characters or numbers.
  900.  
  901.            In "This", "This" is a word. "is" is not a word.  A search
  902.            like    PS *.*/t:is/fw   would show matches for is but will
  903.            not match on the "is" characters in "this".
  904.  
  905.  
  906.      /L    Line numbers.  When you are searching DOS text files for
  907.            specific text (/T: parm used), use the /L parameter when you
  908.            want PSEARCH to determine and display the number of the line
  909.            associated with the text displayed.
  910.  
  911.            DOS text files are those files that have a carriage return
  912.            and line feed at the end of each line of text.  A good
  913.            example of these is DOS batch command files (*.BAT).  Word
  914.            processing files often do not use this format and so line
  915.            number specifications are not often useful for them.
  916.  
  917.  
  918.      /N:nnn Newdays - Indicates that only files created or updated
  919.            within the last nnn days are to be selected for processing.
  920.            /N:1 causes any files updated within the last day to be
  921.            selected. To search for files updated on the current date,
  922.            specify /N:0.
  923.  
  924.  
  925.      /ND   No Data.  For text searches, PSEARCH normally displays the
  926.            text data lines for matching data found in files searched.
  927.            If you only need the filenames shown, use the /ND parameter
  928.            to deactivate the text display.
  929.  
  930.  
  931.      /NM   No Multiples.  For text search specifications, causes
  932.            PSEARCH to only search for a single matching text
  933.            in any file and displays only one match.  Other matches
  934.            may exist in the file.
  935.  
  936.  
  937.      /NO   No mOre - Normally PSEARCH will stop at the end of each full
  938.            display of lines.  You may press <ESCAPE> to terminate
  939.            processing, <C> to disable more and display without stopping
  940.            again, or press any other key to display another page of the
  941.            display and stop again.  /NO disables this feature.
  942.  
  943.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 19
  944.      --------------------------------------------------------------------
  945.  
  946.      /NM   Use of the /NM parameter will shorten your display of
  947.            output and may improve search performance by stopping
  948.            the search of a file after a single match is shown.
  949.  
  950.  
  951.      /NW   No Windows.  PSEARCH normally operates in full screen
  952.            window mode.  To deactivate this feature and DISplay all
  953.            output in normal DOS line mode specify this parameter.
  954.  
  955.            The /NW parameter causes PSEARCH to use BIOS type screen
  956.            writes to display output to the display.  The /NW parameter
  957.            may be useful when you have special devices or TSR's
  958.            active that screen or capture output going through these
  959.            interfaces.
  960.  
  961.      /NP   Suppress ALL PSEARCH output.
  962.  
  963.  
  964.      /O:nnn Olddays - Indicates that only files older than nnn days are
  965.            to be selected for processing. /O:365 will cause files over
  966.            one year old to be selected.
  967.  
  968.  
  969.      /P    Pause - Pause  PSEARCH will pause whenever a match of
  970.            filename or text in a file is found. You may terminate the
  971.            search or continue by pressing any key.
  972.  
  973.  
  974.      /PF   Print to File - If you want to direct print to an output
  975.            file, enter /PR. The file PSPRINT.DAT will be created in the
  976.            current directory.  The resulting file may be edited or
  977.            viewed using your current word processor, text editor, or the
  978.            DOS TYPE command.
  979.  
  980.  
  981.      /PR   PRint - Causes all screen output to also be directed to the
  982.            output printer device.  This allows you to have a printed
  983.            record of PSEARCH results.
  984.  
  985.  
  986.      /R:nnn  Near specification for multiple text searches.  You may use
  987.            the /R parameter when you have also specified multiple /T:
  988.            parameters to cause PSEARCH to search for multiple sets of
  989.            text.  /R specifies a number of characters that may exist
  990.            between the first characters of the text to be searched.  In
  991.            other words, the text will only be considered a match if it
  992.            is within n characters of all other text specified.
  993.  
  994.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 20
  995.      --------------------------------------------------------------------
  996.  
  997.            Use the /R when you want to find values related to one
  998.            another and know the values will exist within close proximity
  999.            of each other in the file.  The following example will search
  1000.            files for the name 'Jones' and will identify a letter to this
  1001.            person by indicating the search is only to search for the
  1002.            name 'jones' when it also exists near the letter salutation
  1003.            'Dear'.  The /R:50 value indicates the two values must be
  1004.            within 50 characters of each other in the file.
  1005.  
  1006.                 PS *.*/t:jones/t:near/r:50/ta
  1007.  
  1008.  
  1009.      /RT   Related text.  During text searches /RT will cause PSEARCH
  1010.            to attempt to display up to 10 lines of text related to the
  1011.            matching text being shown.  In many cases, less than 10
  1012.            lines of text may be shown when PSEARCH detects unprintable
  1013.            data or changes in paragraph structure.
  1014.  
  1015.            When /RT is specified, each display of matched text will be
  1016.            separated by horizontal bar lines to help you better see the
  1017.            groups of text being displayed.
  1018.  
  1019.  
  1020.      /S    System - Indicates that all directories on all hard disk
  1021.            drives are to be searched.  If a directory or drive is
  1022.            specified as part of the pathname, only it will be searched.
  1023.  
  1024.  
  1025.      /SO   Turns the PSEARCH signal sounds off.
  1026.  
  1027.  
  1028.      /T:text to be searched
  1029.            Text - Specifies the text to be found for text search
  1030.            requests. The text string may contain any characters. A
  1031.            terminating command line or the following slash character
  1032.            will signal the end of the text to be searched. If this is
  1033.            the last parameter on the command any trailing spaces will
  1034.            not be included in the search. To include trailing spaces,
  1035.            terminate the string with an ending slash character.
  1036.  
  1037.            Text may be specified in upper or lower case. Unless the /C
  1038.            parameter is specified to force exact text matches, the
  1039.            search will be made for any match regardless of case.
  1040.  
  1041.            Strings may also be single or double quoted. This allows for
  1042.            special characters to be included in the search string such
  1043.            as / characters.
  1044.  
  1045.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 21
  1046.      --------------------------------------------------------------------
  1047.  
  1048.            Examples:
  1049.  
  1050.             /T:BUDGET /T:Budget /T:Mr.  Jones/
  1051.             /T:"01/01/88"
  1052.  
  1053.            Note, to include a trailing space as part of search text, you
  1054.            must follow search text by another / command parameter. For
  1055.            example:
  1056.  
  1057.             PS *.C/T: SMITH /TA
  1058.  
  1059.            Up to five (5) /T: parameter specifications may be included
  1060.            for text search requests.  This allows PSEARCH to search for
  1061.            five different texts on a single search of a disk or
  1062.            directory. When multiple text is specified, consider the use
  1063.            of the /TA parameter to force PSEARCH to find all text in a
  1064.            single file before considering the file a match.
  1065.  
  1066.            The /T: parameter serves the purpose of indicating to PSEARCH
  1067.            of the search is to be for text in a file or for file names.
  1068.            Any command line execution of PSEARCH without the /T:
  1069.            parameter will cause PSEARCH to assume the request is to
  1070.            locate files by name only.
  1071.  
  1072.  
  1073.      /TA   Text 'AND'.  Used for mutiple text searches.  Indicates
  1074.            that all text must be found in the file for a PSEARCH
  1075.            to display a match.  Without /TA specified, any matching
  1076.            text will be displayed.
  1077.  
  1078.  
  1079.      /X:xxx eXecute - Build and execute a DOS command whenever a
  1080.            filename match or a text match is found. xxx is the DOS
  1081.            command to be executed.
  1082.  
  1083.            The command may either be a standard DOS command or the name
  1084.            of a DOS batch command file. The command will be executed
  1085.            with a second copy of COMMAND.COM. The command data may
  1086.            contain the following special characters to allow for
  1087.            substitution values.
  1088.  
  1089.               # - Always replaced with the selected filename
  1090.  
  1091.               & - Always replaced with the selected path/filename
  1092.  
  1093.               ! - Always replaced with the filename without extension
  1094.  
  1095.               @ - Replaced with a slash to allow for command parameters
  1096.                   to be specified in executed commands.
  1097.  
  1098.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 22
  1099.      --------------------------------------------------------------------
  1100.  
  1101.  
  1102.            Examples:
  1103.  
  1104.               /X:ERASE &To delete selected files
  1105.               /X:ARC A OLD123.ARC # To use ARC utility to archive
  1106.                                     file
  1107.               /X:TYPE & To type the file
  1108.               /X:LOTUS Start 123 for the file
  1109.  
  1110.  
  1111.      /XF:xxx eXecute File - Works like /X except that the command is not
  1112.            executed, it is generated and placed in a DOS batch command
  1113.            file named PSCMDS.BAT in the current directory. This file may
  1114.            be edited before it is executed.
  1115.  
  1116.  
  1117.      /XP:xxx eXecute with Pause - Functions in the same way as the /X
  1118.            parameter except that you are asked to indicate if the
  1119.            command is to be executed for each selected file.
  1120.  
  1121.  
  1122.      Specification of default parameters
  1123.      -----------------------------------
  1124.  
  1125.      Default parameters are parameters that do not need to be specified
  1126.      each time PSEARCH is started. Any PSEARCH parameter may be
  1127.      specified as a default parameter.
  1128.  
  1129.      Use the DOS SET command to specify the parameter name and contents
  1130.      to be used by PSEARCH each time it is started. The following
  1131.      example indicates the /EX exclude parameter specification is to be
  1132.      automatically provided to PSEARCH each time it is used in the
  1133.      command mode.
  1134.  
  1135.        SET PSEARCH=/D/M
  1136.  
  1137.      Once this DOS command is issued, each subsequent use of PSEARCH
  1138.      will operate as if these parameters have been specified on the
  1139.      command line. The SET command is most commonly placed in the
  1140.      AUTOEXEC.BAT file so it may be in effect every time your machine is
  1141.      started.
  1142.  
  1143.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 23
  1144.      --------------------------------------------------------------------
  1145.  
  1146.      Screen colors and monitor support
  1147.      ---------------------------------
  1148.  
  1149.      PSEARCH checks the DOS equipment flags to determine what type of
  1150.      monitor you have on your system. This is usually always correct
  1151.      except for one specific information. For those users running a
  1152.      composite monitor with a color graphics card, the screens may not
  1153.      be displayed correctly. If this occurs, use the DOS MODE command to
  1154.      set your environment to black and white. This can be done at system
  1155.      startup or just before starting PSEARCH. Beware that some
  1156.      applications incorrectly reset these indicators and they may need
  1157.      to be reset before again running PSEARCH. Following is an example,
  1158.      see the DOS reference for more information about setting the
  1159.      monitor with the MODE command.
  1160.  
  1161.         DOS MODE command example ===>  MODE BW80
  1162.  
  1163.  
  1164.      Pausing the Search
  1165.      ------------------
  1166.  
  1167.      Even if the Pause parameter is not specified, you may pause the
  1168.      search at any time by pressing any keyboard key. At the end of the
  1169.      next process PSEARCH will pause. You will then have the opportunity
  1170.      to continue processing, use a function key, or exit from PSEARCH.
  1171.  
  1172.  
  1173.      Bonus features for registered users                                     |
  1174.      -----------------------------------                                     |
  1175.                                                                              |
  1176.       To encourage users to register, the following "bonus" features are
  1177.       made available only to registered users.  When you register your
  1178.       use of this utility by completing the registration form and
  1179.       sending it in with the requested fee, you will soon receive
  1180.       special codes to unlock these bonus features for your use.  These
  1181.       unlocking codes will work for the current and all future versions
  1182.       of the utility.
  1183.  
  1184.       I apologize for having to implement locked out features, but after
  1185.       5 years of experience of developing Shareware it is clear that
  1186.       most users will not register utility software without having
  1187.       something to encourage them. The bonus features provide a small
  1188.       reward for those who do take the time to register.
  1189.                                                                              |
  1190.        /RT - Ability to show related text for search matches
  1191.        /PR - Direct display output to the line printer
  1192.        /PF - Direct display output to a print file
  1193.        /SO - Turn off the sound
  1194.        /DR: - Multiple drive support is limited to 2 drives
  1195.        Use of the PSEARCH= environment variable.
  1196.  
  1197.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 24
  1198.      --------------------------------------------------------------------
  1199.  
  1200.      Program Maintenance History
  1201.      ---------------------------
  1202.  
  1203.      There is an ongoing commitment to improve PSEARCH as long as there
  1204.      is expressed need by PSEARCH users. I do respond to your requests.
  1205.      The enhancements below reflect both user requests and my own ideas.
  1206.      Please let me know of your needs, maybe they can appear on this
  1207.      list in the future.
  1208.  
  1209.      ------------------------------------------------------------------
  1210.  
  1211.      Version 1.0      March 1, 1986
  1212.           --  PSEARCH Version 1.0 was released in March 1st, 1986
  1213.  
  1214.      Version 2.0      April 8, 1986
  1215.           PSEARCH Version 2.0 was released April 8th, 1986. It
  1216.               upgraded version 1 with the following new features.
  1217.  
  1218.           -- Ability to search in .ARC files for filenames /AR /AO
  1219.           -- Find text by WORD, PREFIX, or SUFFIX /FW /FP /FS
  1220.           -- Returns back to menus after search is complete
  1221.           -- Extract data to file implemented
  1222.           -- Fix to show found text un upper/lower case
  1223.           -- /SO to turn sound off
  1224.           -- Ability to exclude .COM and .EXE files from search
  1225.           -- Ability to search all drives attached to system /DR:abc
  1226.  
  1227.      Version 3.0      September 7, 1986
  1228.           PSEARCH Version 3.0 was released Sept. 7th, 1986. It upgraded
  1229.           version 2 with the following new features.
  1230.  
  1231.           -- Sound alike and other new filespec wildcards (! ; ~).
  1232.           -- More menu options on the Peak menu.
  1233.           -- Correction to retrieve proper environment string to be used
  1234.              when executing DOS commands.
  1235.  
  1236.      Version 3.3      July 5, 1987
  1237.           -- Change registration so there is no longer a need to have
  1238.              the PSEARCH.REG file exist in the root directory.
  1239.  
  1240.           -- Text searches will not attempt to search .ARC files. Since
  1241.              these files are compressed it makes no sense to search them
  1242.              for text.
  1243.  
  1244.           -- Use environment field PS= to specify default command
  1245.              parameters.
  1246.  
  1247.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 25
  1248.      --------------------------------------------------------------------
  1249.  
  1250.      Version 3.4      September 16, 1987
  1251.  
  1252.           -- Ignore ~ ! and ; filename search characters unless they are
  1253.              in the first position of the filename. Previous versions
  1254.              file searches would fail if these characters were found in
  1255.              any position but the first.
  1256.  
  1257.           -- Correct filename matching. If file XXX would not be found
  1258.              if pattern name of XXX.* was specified.
  1259.  
  1260.           -- When print option was used with menus, when processing
  1261.              completed, menu text was printed to the printer. Corrected.
  1262.  
  1263.  
  1264.      Version 3.8      March 1, 1988
  1265.  
  1266.           -- Add ability to accept " or ' quoted strings in text search
  1267.              input command data. This is for the /T: parameter only.
  1268.  
  1269.  
  1270.      Version 4.0      February 22,1990
  1271.  
  1272.           This version is essentially a rewrite of the original PSEARCH
  1273.           facility.  All the changes are too numerous to mention.
  1274.           Following is a list of the most significant changes.
  1275.  
  1276.           Enhancements...
  1277.           -- Add ability to search up to 5 text strings
  1278.           -- AND/OR capability on text strings
  1279.           -- New exclude file allows user to specify file names
  1280.           -- New menu structure
  1281.           -- Near parameter to force multiple text matches to be within
  1282.              n characters of each other.
  1283.           -- /NW implements no window mode for those that need or prefer
  1284.              DOS style displays.
  1285.           -- /DS parameter allows a single directory path including all
  1286.              subordinate directories to be searched.
  1287.           -- The limit of the number of directories that can be searched
  1288.              greatly enhanced.  The maximum number of directories is
  1289.              related to the amount of free memory available to PSEARCH.
  1290.  
  1291.           Items removed...
  1292.           -- The Peak feature has been removed.
  1293.           -- The 5 text strings replaces the ability to specify a ?
  1294.              in the text search string.
  1295.           -- The exclude file replaces the /SK command to skip
  1296.              .COM and .EXE files.
  1297.  
  1298.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 26
  1299.      --------------------------------------------------------------------
  1300.  
  1301.  
  1302.      Version 4.1      February 26, 1990
  1303.           -- System lockup during speaker beeps.  Also improper beeps.
  1304.           -- Set sounds off as default
  1305.           -- Set pause at full screen (more) as default in command mode
  1306.  
  1307.      Version 4.2      March 9, 1990
  1308.           -- Added /RT parm to show related text
  1309.           -- Added field edit capabilities.
  1310.           -- Removed more line from display after user pressed a key
  1311.           -- Replaced /MO with /NO.  More was made default.
  1312.  
  1313.      Version 4.3      May 4, 1990
  1314.           -- Corrected errors encountered when processing .ZIP files
  1315.              containing directory names as well as filenames.
  1316.           -- Corrected problem where PSEARCH ignored the drive
  1317.              specification for the path to be searched.
  1318.           -- Added directory name to filename display on search display
  1319.           -- Added a screen of condensed help.
  1320.           -- Improved screen I/O performance
  1321.           -- Removed requirement to place quotes around text to be
  1322.              searched for in command line.  You may now search for
  1323.              data containing spaces.
  1324.                  PS *.TXT/T:Joe Doe
  1325.           -- File find now searches all hard disk drives unless a
  1326.              specific drive is specified.
  1327.           -- /S parameter causes all hard disk drives to be scanned
  1328.              unless a specific drive is specified in the supplied
  1329.              pathname.
  1330.  
  1331.      Version 4.4a     July 11, 1990
  1332.           -- When PS *.exe/DS used.  The same directory was searched
  1333.              3 times.  This only happened when directory had no
  1334.              subdirectories.  PS was fixed to scan the directory once.
  1335.           -- For network operation  -- added auto skipping of any files
  1336.              DOS denied access to.  A message is printed for each file
  1337.              that is bypassed.
  1338.           -- Detect bad exclude file specifications and stop processing.
  1339.              Processing used to continue but not select any files.
  1340.           -- PSEARCH was searching all directories for a file even when
  1341.              a specific pathname was specified.  The search is now
  1342.              limited to just the specified pathname.
  1343.           -- Support multiple drive parameter (/DR:) when directory name
  1344.              specified.  Allows multiple drives to be searched for a
  1345.              single directory name.
  1346.           -- PS *.* /AT:u stopped displaying output when readonly,
  1347.              hidden, system, updated file displayed.
  1348.           -- Added [=blank and ]=\ to /X: command substitution
  1349.      Version 4.4c  December 17, 1990
  1350.           -- Added capability to specify a list of files to be searched
  1351.              on the command line using the "@" symbol.
  1352.           -- Added the /NP (No Print) parameter
  1353.           -- Enhanced the .EXC file to be able to process SELect and EXClude
  1354.              statements.
  1355.      Version 4.4D
  1356.           -- Fixed problem with registration info not displayed.
  1357.  
  1358.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 27
  1359.      --------------------------------------------------------------------
  1360.  
  1361.         Registering The Utilities
  1362.         -------------------------
  1363.  
  1364.         PSEARCH is distributed under the Shareware concept. This allows
  1365.         users to evaluate software for a short time to determine if it
  1366.         is useful to them.  If you decide the software is of value to
  1367.         you and decide to keep and use, you are required to register it.
  1368.  
  1369.         This concept allows for quality software to be distributed at a
  1370.         reasonable cost.  Hundreds of hours of my time has been invested
  1371.         in PSEARCH.  Continued registration will justify the continued
  1372.         upgrading of this utility to insure it remains up to date with
  1373.         current technology.  In any case, I do greatly appreciate all
  1374.         users that care enough to register.  I try to provide the best
  1375.         possible software for all you faithful supporting users.
  1376.  
  1377.         You may use the order form on the next page when registering.
  1378.  
  1379.         Send registration requests to:
  1380.  
  1381.                   Patri-Soft
  1382.                   P.O. Box 8263
  1383.                   San Bernardino, CA   92412
  1384.  
  1385.         The registration charge is a one time fee that entitles you to
  1386.         all future versions of the product.  These may either be
  1387.         obtained from normal Shareware sources or from me.  I do not
  1388.         automatically  send product updates to registered users.  It is
  1389.         impossible to provide automatic upgrades at the low costs of
  1390.         these utilities.  If you would like to receive the next version
  1391.         of the software, add an additional $15 to your order and
  1392.         indicate on the order form you wish to receive the next update
  1393.         version.  You will be sent the next version along with an
  1394.         optional order form to request subsequent releases.
  1395.  
  1396.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 28
  1397.      --------------------------------------------------------------------
  1398.  
  1399.    Site licensing plans for one or more Patriquin utilities:
  1400.    ---------------------------------------------------------
  1401.  
  1402.                1.   Site licensing fees are as follows:
  1403.  
  1404.                     The  first  five  copies  of  any  or all utilities are
  1405.                     purchased  at  full  price.    If   all  utilities  are
  1406.                     purchased, printed  documentation is included for these
  1407.                     first 5 copies.
  1408.  
  1409.                     All  additional  copies  of  any  utility  or  complete
  1410.                     package are 1/3 off the normal price.
  1411.  
  1412.                     You  pay   a  maximum   of  $2000.00  to  register  any
  1413.                     individual utility or $4500.00  for all  utilities, for
  1414.                     an entire site.  This gives your installation rights to
  1415.                     copy and distribute the  utilities  to  anyone  at your
  1416.                     site.   This also  allows "at-home"  use of any utility
  1417.                     for any person at the site.
  1418.  
  1419.                     A site is a company location in one  city.   A location
  1420.                     in another city is considered a second site.
  1421.  
  1422.                     If a utility is placed on a LAN, each regular user of a
  1423.                     utility placed on the  LAN should  be registered.   Use
  1424.                     your own good judgement here.
  1425.  
  1426.  
  1427.  
  1428.         PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 28
  1429.         --------------------------------------------------------------------
  1430.  
  1431.        VISA / Mastercard / Telephone Registration
  1432.         ------------------------------------------
  1433.  
  1434.         You may place a telephone order for the utilities using your credit
  1435.         card by calling Nelson Ford's Public (Software) Library.
  1436.  
  1437.              Telephone orders: 800-242-4775 or 713-665-7017
  1438.  
  1439.         The  PSL  supplies Shareware  software  at  a nominal  cost  to its
  1440.         customers.  Consider them for all your Shareware needs.
  1441.                              ----     OR    ------
  1442.          You may call the Patri-Soft BBS and register online.  The number
  1443.          is (714) 352-2825 1200/14000 8-N-1.  Fill out script 2 to place
  1444.          your order.  Credit card orders are also accepted through U.S. Mail.
  1445.  
  1446.          REGISTRATION
  1447.          ------------
  1448.  
  1449.          Patri-Soft provides full support to users, both registered and
  1450.          non-registered.  We provide support through several different way:
  1451.  
  1452.                  U.S. Mail  -  You may send us problem reports through
  1453.                                the mail. Any extended information that
  1454.                                you can provide is greatly appreciated.
  1455.                                (i.e. screen shots, the actual problem
  1456.                                file, etc).
  1457.  
  1458.                  Telephone  -  You may contact us at (714) 352-2820 to
  1459.                                discuss problems.  However, extended
  1460.                                telephone support may be limited as the
  1461.                                circumstances require.
  1462.  
  1463.                  CIS        -  You may contact us on CompuServe
  1464.                                (76347,2477).  This is usually the
  1465.                                fastest way.
  1466.  
  1467.           A BBS is in operation 24 hours a day to take your enhancement
  1468.           requests and problem reports.  The number for this is
  1469.           (714) 352-2825.  (1200/14000 8-N-1).  Extended access is
  1470.           provided to registered users of the utilities.
  1471.  
  1472.           Patri-Soft offers a money back guarrentee if you are not satisfied
  1473.           with the software.  Simply contact us with the reasons of your
  1474.           dissatisfaction, and we will gladly refund your money.
  1475.  
  1476.           We at Patri-Soft pride ourself on our user support.  If for
  1477.           some reason you feel that you have not gotten the service you
  1478.           deserve, PLEASE let us know.  We try to respond to ALL users
  1479.           quickly and politely.
  1480.  
  1481.  
  1482.                        PSEARCH 4.4D  Registration Request
  1483.  
  1484.         VISA/Mastercard  orders  are also accepted through telephone orders.
  1485.         Call the Public (Software) Library at 800-242-4775 to order NOW!
  1486.  
  1487.         _____ Registration of all Patriquin Utilities with
  1488.                 disk and bound User's Guide ........................$45.00
  1489.  
  1490.         When you register the below versions, you will receive registration
  1491.         codes along with the latest version of the utility.
  1492.  
  1493.         _____ PSEARCH   -- Advanced find files with text............$20.00
  1494.         _____ PCOPY     -- Advanced windowed DOS COPY alternative...$20.00
  1495.         _____ PALERT    -- Warns you of low disk space..............$15.00
  1496.         _____ PATTR     -- Manage attributes of DOS files...........$10.00
  1497.         _____ PDAILY    -- Automatically execute commands once/day..$10.00
  1498.         _____ PDELETE   -- Save space with automatic disk cleanup...$15.00
  1499.         _____ PPRINT    -- Advanced file print w/special formats....$15.00
  1500.  
  1501.         _____ Next Update  Please send me the next version
  1502.                            automatically when it is available.......$15.00
  1503.  
  1504.         _____ Update a registered set with new disk and manual.
  1505.                  Registered users only Ser: __________   ...........$15.00
  1506.  
  1507.                       Disk Size?     5 1/4     3 1/2
  1508.         *******************************************************************
  1509.  
  1510.         Name: __________________________________________________
  1511.  
  1512.         Company: _______________________________________________
  1513.  
  1514.         Address: _______________________________________________
  1515.  
  1516.                  _______________________________________________
  1517.  
  1518.         City: ________________________  State: ________  Zip: __________
  1519.  
  1520.         Method of Payment:
  1521.  
  1522.             ______  Check enclosed
  1523.  
  1524.             ______  Credit card, (Visa, Mastercard only)
  1525.  
  1526.                     Account number:  __________________________________
  1527.  
  1528.                     Exp. Date:  _____________
  1529.  
  1530.         Please register the software under the following name:
  1531.  
  1532.              ____________________________________________________________
  1533.  
  1534.         I learned about the utilities from: ____________________________
  1535.  
  1536.         If BBS (name/number)____________________________________________
  1537.  
  1538.           Send to Patri-Soft, P.O. Box 8263, San Bernardino, CA  92412
  1539.  
  1540.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 30
  1541.      --------------------------------------------------------------------
  1542.  
  1543.                       Reporting Problems  (PSEARCH 4.4D)
  1544.  
  1545.         I welcome all comments or enhancement suggestions.  Please
  1546.         document each item clearly and provide printed examples, if
  1547.         possible. Please be sure to include this form with all requests.
  1548.         It will help to make sure we can provide you with the best
  1549.         possible service.
  1550.  
  1551.  
  1552.         Name: __________________________________________________________
  1553.  
  1554.         Company: _______________________________________________________
  1555.  
  1556.         Address: _______________________________________________________
  1557.  
  1558.                   _______________________________________________________
  1559.  
  1560.         City: __________________________________  State: _______________
  1561.  
  1562.         Zip: ______________________________
  1563.  
  1564.         Telephone: _______ / ________________________ (Home / Work)
  1565.  
  1566.  
  1567.         Date: _________________________     Machine Type:_______________
  1568.  
  1569.  
  1570.         Name of Utility: _______________________ DOS Level: ____________
  1571.  
  1572.         Description of problem or enhancement:
  1573.  
  1574.         ________________________________________________________________
  1575.  
  1576.         ________________________________________________________________
  1577.  
  1578.         ________________________________________________________________
  1579.  
  1580.         ________________________________________________________________
  1581.  
  1582.         Suggested solution:
  1583.  
  1584.         ________________________________________________________________
  1585.  
  1586.         ________________________________________________________________
  1587.  
  1588.